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Chapter 1 


Introduction 


This document details the requirements of the functions implemented for the DCS 
Adapter, an adapter between Rockwell Automation Manufacturing Execution Systems 
(MES; Level 3 for enterprise integration) and Distributed Control Systems (DCS; Level 2 
for enterprise integration). 


Each requirement is composed of a name and a unique identifier (e.g. API - Create a DCS 
Batch (SR9100.1)). If a requirement's meaning is for requirement grouping only, the 
identifier is appended by a plus sign (e.g. Application Programming Interfaces 
(SR9100+)). 


In some cases, additional context information is available, indicated in the document by a 
frame and a gray background color. This context information is related to the respective 
requirement, but not part of the formal requirement description. 


The revision history (page 11) lists the changes made to the document with DCS 2.2 as 
comparison baseline. Changes related to a requirement are marked as "Editorial", 
"Update", "New", or "Deleted", changes to the additional context information are marked 
as "Context information-related". 


Typographical Conventions 
This documentation uses typographical conventions to enhance the readability of the 
information it presents. The following kinds of formatting indicate specific information: 
Bold typeface Designates user interface texts, such as 
M window and dialog titles 
menu functions 
panel, tab, and button names 


box labels 


object properties and their values (e.g. status). 
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Chapter 2 


Application Programming Interfaces (SR9100+) 


Interfaces to a Distributed Control System support the communication between an MES 
and the connected DCS. 


The interface towards the MES is implemented in Java, while the interface to the 
DCS uses XML-formatted messages. 
The messages format is based on $88/S95 standards and B2MML, an XML 


implementation of the standards. 

Typically, a middleware component, e.g. ElHub or Apache Camel, is used to 
connect the DCS Adapter to the specific Distributed Control System and 
technology. 


For further details on the architecture, Java API, or XML message formats, please see 
"Technical Manual DCS Adapter" [A1] (page 9). 


Create a DCS Batch (SR9100. 1) 
An MES can request the creation of a batch on the DCS. 
m The request contains the desired DCS batch ID. 


™ In the reply, the DCS indicates whether the batch creation was successful or an 
error has occurred and returns the internal unique batch ID of the created batch. 


Get Values from a DCS Batch (SR9100.2) 
An MES can request to get values from a batch on the DCS. 
m The request contains a list of the IDs and paths of the value to be used. 


™ In the reply, for each ID and path, the DCS returns the value if it is already 
available or an error message if the values could not be used successfully. 


Get GxP-relevant Alarms from the DCS (SR9100.3) 


An MES can request to get the GxP-relevant alarms from the DCS. 
The alarms can be related to a batch, a unit, and/or a particular timeframe depending on 
the request parameters. 


m The request contains the query parameters that restrict the list of alarms. 
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mM In the reply, the DCS returns the list of alarms matching the query or an error 
message if the alarm could not be used successfully. 


Set Order Context (SR9100.4) 
An MES can request to set an order context on the DCS. 


m The request contains the order-related data including the list of material 
parameters. 


™ In the reply, the DCS indicates whether the order context could be set successfully 
or an error has occurred. 


Receive Consumed Material (SR9100.5) 
DCS can notify an MES that material has been consumed. 
m The request contains information about the consumed material. 


@ In the reply, the MES indicates whether the consumed material event was 
processed successfully or an error has occurred. 


Receive Produced Material (SR9100.6) 
DCS can notify an MES that material has been produced. 
m The request contains information about the produced material. 


@ In the reply, the MES indicates whether the produced material event was 
processed successfully or an error has occurred. 


Get Information of an MES Batch (SR9100.7) 


DCS can request to get information of a batch on an MES. 


m The request contains the batch ID and material of the batch for which information 
is required. 


™ In the reply, the MES returns all relevant batch information. 
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Receive DCS Event (SR9100.8) 


>» For recent changes, see revision history (page 11). 


DCS can send a message event to the MES for synchronization purposes (e.g. to notify an 
MES that a subsequent process can be started). 

The interface supports the asynchronous use case in which it is not necessary that the 
receiver is already running when the request is sent. 

Default is the synchronous use case. 


m The request contains the identifier of the message, the message itself, the batch 
ID, and the material of the affected batch. 


™ In the reply, the MES indicates whether the message event was processed 
successfully or an error has occurred. 


Set Parameter Values (SR9100.9) 


> For recent changes, see revision history (page 11). 


An MES can request to set a set of dynamically configurable parameter values to the 
DCS. 


m The request contains information to address the automation system, a list of the 
IDs, values, and categories of the values to be set. 


m In the reply, the DCS indicates whether the values could be set successfully or an 
error has occurred. 


Get Parameter Values (SR9100.10) 


> For recent changes, see revision history (page 11). 


An MES can request to get a set of dynamically configurable parameter values from the 
DCS. 


m The request contains information to address the automation system, a list of the 
IDs and paths of the value to be used. 


™ In the reply, for each ID and path, the DCS returns the value if it is already 
available or an error message if the values could not be used successfully. 
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Chapter 3 


Integration Implementations 


The following integration implementations are available for Rockwell Automation 
products: 


Mm PharmaSuite MES integration points 
For the PharmaSuite MES solution, deployable integration components are 
available. 
For more information, please refer to PharmaSuite and its "Functional 
Requirement Specification DCS Phases” [A2] (page 9). 


m PlantPAx DCS integration Points 
For the PlantPAx DCS integration, please refer to the solution provided by your 
Rockwell Automation contact. 
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Chapter 4 


Reference Documents 


The following documents are available from the Rockwell Automation Download Site. 


A1_ Technical Manual DCS Adapter DCTMAD-GRO02B-EN-E 
A2__ PharmaSuite Functional Requirement Specification DCS Phases PSFRSDC-RMO02B-EN-E 


TIP 


To access the Rockwell Automation Download Site, you need to acquire a user account 
from Rockwell Automation Sales or Support. 
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Appendix A 


Document Information 


The document information covers various data related to the document. 


Approval 


This document has been approved electronically via the Rockwell Automation Document 
Management System (DMS). The required approvers of this document include the 
following: 


Product Manager 


Development Manager 
Test Manager 


In addition, the electronic document approval via DMS is confirmed by a handwritten 
signature of all approvers in the Documents and Approval document when the release is 


completed. 


Version Information 


Revision History 


The following table describes the history of this document. 


Changes related to the document: 
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Changes related to "Application Programming Interfaces" (page 3): 


Receive DCS Event (SR9100.8) | Update 1.0 
(page 5) Interface supports the asynchronous use case 


Set Parameter Values New 
(SR9100.9) (page 5) New interface to set a set of dynamically configurable 
parameter values on the DCS. 


Get Parameter Values New 1.0 
(SR9100.10) (page 5) New interface to get a set of dynamically configurable 
parameter values from the DCS. 


Changes related to "Integration Implementations" (page 7): 
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